namespace ddidotnet
{
    /// <summary>
    ///     Variable group type
    ///     Variable group determines variables that may share a common subject,
    ///     arise from interpretation of a single question, or are linked by
    ///     some other factor.
    /// </summary>
    public enum DdiGroupType
    {
        /// <summary>
        ///     Questions which derive from the same section of the questionnaire,
        ///     e.g., all variables located in Section C.
        /// </summary>
        Section,

        /// <summary>
        ///     Questions where the respondent has the opportunity to select more
        ///     than one answer from a variety of choices.
        /// </summary>
        MultipleResp,

        /// <summary>
        ///     Sub-question of an introductory or main question, but which do
        ///     not constitute a multiple response group.
        /// </summary>
        Grid,

        /// <summary>
        ///     Questions which appear on the same interview screen (CAI) together
        ///     or are presented to the interviewer or respondent as a group.
        /// </summary>
        Display,

        /// <summary>
        ///     The same variable (or group of variables) which are repeated for
        ///     different groups of respondents or for the same respondent at a
        ///     different time.
        /// </summary>
        Repetition,

        /// <summary>
        ///     Questions which address a common topic or subject, e.g., income,
        ///     poverty, children.
        /// </summary>
        Subject,

        /// <summary>
        ///     Variables, often appearing in pairs, which represent different aspects
        ///     of the same question, e.g., pairs of variables (or groups) which are
        ///     adjusted/unadjusted for inflation or season or whatever, pairs of
        ///     variables with/without missing data imputed, and versions of the same
        ///     basic question.
        /// </summary>
        Version,

        /// <summary>
        ///     Questions that appear in different sections of the data file measuring
        ///     a common subject in different ways, e.g., a set of variables which
        ///     report the progression of respondent income over the life course.
        /// </summary>
        Iteration,

        /// <summary>
        ///     Variables combined into the same index, e.g., the components of a
        ///     calculation, such as the numerator and the denominator of an economic
        ///     statistic.
        /// </summary>
        Analysis,

        /// <summary>
        ///     A variable group without shared properties.
        /// </summary>
        Pragmatic,

        /// <summary>
        ///     Variable from a single record in a hierarchical file.
        /// </summary>
        Record,

        /// <summary>
        ///     Variable from a single file in a multi-file study.
        /// </summary>
        File,

        /// <summary>
        ///     Variables generated by CAI surveys produced by one or more random
        ///     number variables together with a response variable, e.g, random
        ///     variable X which could equal 1 or 2 (at random) which in turn would
        ///     control whether Q.23 is worded "men" or "women", e.g., would you
        ///     favor helping [men/women] laid off from a factory obtain training
        ///     for a new job?
        /// </summary>
        Randomized,

        /// <summary>
        ///     Variables which do not fit easily into any of the categories listed
        ///     above, e.g., a group of variables whose documentation is in another
        ///     language.
        /// </summary>
        Other
    }
}
